Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Universal Imaging Messages

GXImageJob

QuickDraw GX sends the GXImageJob message at the start of the imaging phase of printing, when a print job is ready to print. You can override the GXImageJob message to affect the way an entire job is printed. Your override of the GXImageJob message must match the following formal declaration:

OSErr MyImageJob (gxSpoolFile aSpoolFile, long *closeOptions);

aSpoolFile

The spool file.

closeOptions

A pointer to the spool-file closing options for the job. These are passed on to the GXCloseSpoolFile message at the end of spooling. You can use the values that are shown in Table 4-6 on page 4-80.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXImageJob message at the start of imaging when it determines that a print job in the queue is ready to be printed.

The default implementation of GXImageJob prints an entire spool file. It first determines whether the file is to be printed on the local Macintosh or sent to a remote station. In the default implementation, QuickDraw GX sends the GXOpenConnection message to open the printer connection. Next, it sends the GXSetupImageData message so that the imaging system can set up its imaging time data. It also sends the GXImageDocument message to begin imaging the document. And finally, it sends the GXCloseConnection message to close the connection to the printer.

SPECIAL CONSIDERATIONS

You never send the GXImageJob message yourself.

You must forward the GXImageJob message to other message handlers. You can perform your tasks before or after forwarding the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXCloseSpoolFile message is described on page 4-79.

The GXSetupImageData message is described on page 4-92.

The GXImageDocument message is described on page 4-93.

The GXOpenConnection message is described on page 4-131.

The GXCloseCOnnection message is described on page 4-135.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help